INSTRUCTIVO DE USO
SCRIPT: INGRESO_AGREGADO.R
PROCESO: CALCULO DE INGRESOS DEL HOGAR DESDE BASES ORIGINALES CARGADAS EN .RData

==============================================================================
1. OBJETIVO DEL SCRIPT
==============================================================================

Este script calcula las variables de ingresos del hogar a partir del archivo:

  Bases_trabajo.RData

El script NO trabaja con archivos .sav individuales y NO trabaja con archivos
PURA_*.rds. Tampoco usa la base ENIGHUR2025_HOGARES_AGREGADOS, porque el
objetivo es recalcular los ingresos desde las bases originales cargadas dentro
del archivo .RData.

Al finalizar, el script deja solamente dos objetos en el entorno de RStudio:

  BASE_INGRESOS_FINAL
  DICCIONARIO_INGRESOS_FINAL

BASE_INGRESOS_FINAL es la base final que debe usarse para los análisis de
ingresos.

==============================================================================
2. ARCHIVOS NECESARIOS
==============================================================================

Antes de ejecutar el script, debe existir el archivo:

  C:/Users/dlopez/Desktop/ENIGHUR 29_MAYO/Bases_trabajo.RData

Dentro de ese archivo .RData deben existir, al menos, estas bases:

  ENIGHUR2025_INGRESOS_H
  ENIGHUR2025_PERSONAS_INGRESOS
  ENIGHUR2025_GASTOS_REGALOS

La base ENIGHUR2025_GASTOS_REGALOS se utiliza únicamente para calcular el ingreso
por regalos y el alquiler imputado dentro del ingreso no monetario. Al final no
queda cargada en el entorno.

IMPORTANTE:
El script no necesita que el usuario abra manualmente las bases .sav. Todo se
carga desde Bases_trabajo.RData.

==============================================================================
3. PAQUETES NECESARIOS
==============================================================================

El script utiliza estos paquetes de R:

  haven
  data.table
  dplyr
  openxlsx

Si no están instalados, ejecutar una sola vez:

  install.packages("haven")
  install.packages("data.table")
  install.packages("dplyr")
  install.packages("openxlsx")

Luego el script los carga automáticamente con library().

==============================================================================
4. COMO EJECUTAR EL SCRIPT EN RSTUDIO
==============================================================================

Paso 1. Abrir RStudio.

Paso 2. Abrir el archivo:

  TAB_ING_RDATA_SOLO_INGRESOS.R

Paso 3. Verificar que la ruta del archivo .RData sea correcta:

  C:/Users/dlopez/Desktop/ENIGHUR 29_MAYO/Bases_trabajo.RData

El script también prueba esta ruta alternativa por si estuviera escrita así:

  C:/Users/dlopez/Deskop/ENIGHUR 29_MAYO/Bases_trabajo.RData

Sin embargo, lo normal en Windows es "Desktop".

Paso 4. Ejecutar todo el script con:

  Ctrl + Shift + Enter

O desde el menú de RStudio:

  Source

Paso 5. Esperar el mensaje final:

  PROCESO FINALIZADO CORRECTAMENTE

==============================================================================
5. QUE HACE EL SCRIPT INTERNAMENTE
==============================================================================

El script realiza las siguientes acciones:

1. Carga el archivo Bases_trabajo.RData.
2. Busca las bases originales necesarias dentro del entorno cargado.
3. Limpia etiquetas/formato SPSS para poder calcular sin problemas.
4. Convierte valores negativos numéricos a cero.
5. Calcula número de personas por hogar.
6. Calcula ingreso agropecuario.
7. Calcula ingreso del trabajo asalariado monetario.
8. Calcula ingreso del trabajo independiente monetario.
9. Calcula ingresos por otros trabajos.
10. Calcula ingreso monetario del trabajo.
11. Calcula ingresos por renta de propiedad y capital.
12. Calcula transferencias corrientes.
13. Calcula otros ingresos corrientes.
14. Calcula ingreso corriente monetario del hogar.
15. Calcula ingreso corriente no monetario del hogar.
16. Calcula ingreso por regalos y alquiler imputado.
17. Calcula ingreso corriente total del hogar.
18. Calcula ingreso corriente per cápita.
19. Genera el tabulado nacional, urbano y rural.
20. Genera validaciones de ingreso.
21. Genera un diccionario de variables finales.
22. Exporta los resultados.
23. Limpia el entorno y deja solo la base final y el diccionario.

==============================================================================
6. BASE FINAL QUE DEBE USARSE
==============================================================================

La base final que debe usarse después de ejecutar el script es:

  BASE_INGRESOS_FINAL

Para verla en RStudio:

  View(BASE_INGRESOS_FINAL)

Para revisar sus variables:

  names(BASE_INGRESOS_FINAL)

Para revisar su dimensión:

  dim(BASE_INGRESOS_FINAL)

==============================================================================
7. DICCIONARIO FINAL
==============================================================================

El script también genera un diccionario de variables finales:

  DICCIONARIO_INGRESOS_FINAL

Para verlo en RStudio:

  View(DICCIONARIO_INGRESOS_FINAL)

Este diccionario contiene dos columnas:

  variable
  etiqueta

Sirve para revisar el nombre técnico de cada variable y su descripción.

==============================================================================
8. ARCHIVOS QUE SE GENERAN
==============================================================================

Al finalizar, el script genera tres archivos en la carpeta de trabajo de RStudio:

1. Excel de resultados:

  INGRESOS_NACIONAL_AREA_MUESTRAL_EXPANDIDO.xlsx

2. Base final en formato .RData:

  BASE_INGRESOS_FINAL.RData

3. Diccionario de variables en formato .csv:

  DICCIONARIO_INGRESOS_FINAL.csv

Para saber en qué carpeta se guardaron, ejecutar en RStudio:

  getwd()

==============================================================================
9. HOJAS DEL EXCEL GENERADO
==============================================================================

El archivo Excel generado contiene estas hojas:

1. INGRESOS
   Contiene el tabulado de ingresos por Nacional, Urbano y Rural, tanto muestral
   como expandido.

2. VALIDACION_ING
   Contiene validaciones de las principales variables de ingreso.

3. AREA_ING
   Contiene validación por área: urbano y rural.

4. DICCIONARIO
   Contiene el diccionario de variables finales incluidas en la base.

==============================================================================
10. VARIABLES PRINCIPALES DE INGRESO
==============================================================================

Entre las principales variables generadas se encuentran:

  ing_cor_tot          Ingreso corriente total del hogar
  ing_mon_cor          Ingreso corriente monetario del hogar
  ing_trab_mon         Ingresos por trabajo monetario
  ing_asal_mon_net     Ingreso del trabajo asalariado monetario neto
  suel_sal_bruto       Sueldos y salarios monetarios brutos
  deduccion_asalariado Deducciones de asalariados
  ING_OTRO_NETO        Otros ingresos del trabajo asalariado netos
  ing_ind_mon_net      Ingreso del trabajo independiente monetario neto
  ing_cuent_prop_na    Ingreso monetario independiente no agropecuario
  ing_ag_mon_neto      Ingreso monetario independiente agropecuario
  deduccion_independiente Deducciones de independientes
  ing_ter_ocu          Ingreso de otros trabajos
  ing_ren_prop_cap     Ingresos por renta de propiedad y capital
  ing_ren_prop         Ingresos por renta de la propiedad
  ing_cap              Ingresos del capital
  tranf_cor            Transferencias corrientes
  otro_ing_cor         Otros ingresos corrientes
  ing_no_mon           Ingreso corriente no monetario del hogar
  ing_es_neto          Ingreso asalariado no monetario
  ing_ind_nm           Ingreso independiente no monetario
  autocon_na           Autoconsumo no agropecuario
  ing_bru_agro_no_mon  Ingreso agropecuario no monetario bruto
  ing_reg              Ingreso por regalos
  alq_imp              Alquiler imputado
  ing_cor_per          Ingreso corriente per cápita

==============================================================================
11. QUE NO DEBE HACER EL USUARIO
==============================================================================

No debe cargar manualmente archivos .sav.
No debe usar PURA_INGRESOSH_RAW.rds.
No debe usar PURA_PER_INGRESOS.rds.
No debe usar PURA_GASTOSH_MO.rds.
No debe usar PURA_GASTOS_REG.rds.
No debe usar ENIGHUR2025_HOGARES_AGREGADOS para este proceso.
No debe modificar las variables calculadas si desea mantener consistencia con el
tabulado.

